X1 MK1 BRIDGE – Treiber-Ersatz für den Traktor Kontrol X1 MK1
==============================================================

Ein kostenloses Tool von FREQUENZBETRIEB n.e.V. · frequenzbetrieb.de
Inoffiziell – nicht mit Native Instruments verbunden.

Macht den Traktor Kontrol X1 der ersten Generation unter Traktor Pro 4 wieder nutzbar.
Läuft auf Intel-Macs und Apple Silicon ab macOS 11.
Die App sitzt unauffällig in der Menüleiste (Symbol: Drehregler) und
stellt den X1 als MIDI-Gerät "X1 MK1 Bridge" bereit.


1. INSTALLIEREN
---------------
1. "X1 MK1 Bridge" auf "Programme" ziehen.
2. Die App im Programme-Ordner öffnen.

   Beim ersten Start meldet macOS, dass der Entwickler nicht verifiziert
   werden kann (die App ist nicht bei Apple registriert). So geht's trotzdem:
     • Systemeinstellungen > Datenschutz & Sicherheit > ganz nach unten >
       bei "X1 MK1 Bridge" auf "Dennoch öffnen" klicken.
     • oder im Terminal:
       xattr -dr com.apple.quarantine "/Applications/X1 MK1 Bridge.app"
   Das ist nur einmal nötig.

3. Der Drehregler erscheint oben in der Menüleiste. Ist der X1 angesteckt,
   steht im Menü "verbunden". Die App startet ab jetzt automatisch beim
   Anmelden (abschaltbar im Menü).

WICHTIG: Das alte Programm "X1Mk1 usb2midi" darf nicht gleichzeitig laufen.
Es gibt immer nur ein Programm, das den Controller benutzen kann.


2. IN TRAKTOR EINRICHTEN
------------------------
Traktor > Preferences > Controller Manager > Add... > Import TSI
und eines der Mappings auswählen (Ordner "Traktor-Mappings" im DMG, oder
Menüleisten-Symbol > "Traktor-Mappings im Finder zeigen"):

  • X1 MK1 Bridge - FX 3+4, Decks C+D.tsi   (Ergänzung zum S4 MK3)
      - linke FX-Sektion  = FX-Unit 3
      - rechte FX-Sektion = FX-Unit 4
      - Browse/Loop/Transport/Hotcues = Deck C (links) und Deck D (rechts)
      - Tasten "FX1"/"FX2" pro Seite = Deck C/D auf FX-Unit 3/4 schalten
      Voraussetzungen in Traktor:
        Preferences > Effects > FX Unit Routing: "4 FX Units"
        Preferences > Decks > Deck Layout: 4 Decks

  • X1 MK1 Bridge - Decks A+B.tsi   (klassische X1-Belegung)
      FX-Units 1/2, Decks A/B

Danach prüfen: In-Port und Out-Port = "X1 MK1 Bridge".
Den Hotcue-Modus schaltest du mit der HOTCUE-Taste um: Dann werden die
8 Transport-Tasten pro Seite zu Hotcues 1-8.


3. EIGENE BELEGUNG
------------------
Jede Belegung lässt sich in Traktor frei ändern. Der Treiber sendet nur
"Taste X gedrückt" oder "Regler Y steht auf Z". Was das in Traktor bewirkt,
bestimmt allein das Mapping.

Vorhandene Zuweisung ändern:
  Controller Manager > Gerät "X1 MK1 Bridge" wählen > Eintrag in der Liste
  anklicken > rechts unter "Assignment" z.B. anderes Deck/FX-Unit, oder
  über "Add In..." eine andere Funktion wählen.

Neue Zuweisung per Learn:
  1. "Add In..." > gewünschte Traktor-Funktion auswählen
  2. unten auf "Learn" klicken und die Taste/den Regler am X1 bewegen
  3. "Learn" wieder ausschalten
  4. Einstellen:
       Type of Controller: Button / Fader|Knob / Encoder
       Interaction Mode:   Taste: Hold, Toggle oder Trigger
                           Regler: Direct
                           Encoder: Relative, Encoder Mode "7Fh/01h"
       Assignment:         Deck A-D, FX-Unit 1-4 oder Global
  Mit gehaltenem SHIFT sendet der X1 auf MIDI-Kanal 2 statt 1. Du kannst also
  per Learn einfach SHIFT + Taste drücken und bekommst eine zweite Belegung,
  ganz ohne Modifier.

LED einer Taste ansteuern:
  "Add Out..." > dieselbe Funktion wählen > bei "Controller" (Learn geht bei
  Ausgängen nicht) die Adresse Ch03 > CC > LED-Nummer eintragen:

    Linke FX-Sektion:   ON 8   Taste1 7   Taste2 6   Taste3 5
    Rechte FX-Sektion:  ON 4   Taste1 3   Taste2 2   Taste3 1
    Linke Deck-Seite:   FX1 25  FX2 26  IN 18  OUT 17  <BEAT 20  BEAT> 19
                        CUE 22  CUP 21  PLAY 24  SYNC 23
    Rechte Deck-Seite:  FX1 27  FX2 28  IN 16  OUT 15  <BEAT 14  BEAT> 13
                        CUE 12  CUP 11  PLAY 10  SYNC 9
    Hotcue-LEDs (im Hotcue-Modus): Ch04 > CC 0-15

MIDI-Übersicht (Eingänge, Kanal 1 / mit SHIFT Kanal 2):
    Regler:   FX1 Dry/Wet 0, Knob1 2, Knob2 4, Knob3 6
              FX2 Dry/Wet 1, Knob1 3, Knob2 5, Knob3 7
    FX-Tasten: FX1 ON 8, 1:10, 2:12, 3:14  |  FX2 ON 9, 1:11, 2:13, 3:15
    Browse-Encoder L/R 16/17, drücken 18/19
    FX1-Taste L/R 20/21, FX2-Taste L/R 22/23
    Loop-Encoder L/R 26/27, drücken 24/25
    IN 28/29, OUT 30/31, <BEAT 32/33, BEAT> 34/35
    CUE 36/37, CUP 38/39, PLAY 40/41, SYNC 42/43
    SHIFT 45, HOTCUE 46
    Hotcues (Kanal 4, mit SHIFT 5): links CC 8-15, rechts CC 0-7


4. MENÜLEISTE
-------------
  • Status je Controller (verbunden / kein Gerät / belegt)
  • LEDs testen – kurzes Lauflicht, zeigt, dass die Verbindung steht
  • Traktor-Mappings im Finder zeigen
    (liegen in Dokumente/X1 MK1 Bridge Mappings)
  • Protokoll anzeigen (~/Library/Logs/X1 MK1 Bridge.log)
  • Beim Anmelden automatisch starten
  • Beenden (LEDs gehen aus, der Controller wird freigegeben)

Mehrere X1 werden unterstützt. Der zweite heißt "X1 MK1 Bridge #2".


5. ENTFERNEN
------------
Im Menü "Beim Anmelden automatisch starten" abhaken, "Beenden" wählen und die
App in den Papierkorb legen.


6. LIZENZ & HINWEISE
--------------------
X1 MK1 Bridge ist freie Software unter der Apache-Lizenz 2.0 (LICENSE.txt).
Nutzung ohne Gewähr. Den Quellcode gibt es als ZIP auf frequenzbetrieb.de.

Das Projekt ist inoffiziell und nicht mit der Native Instruments GmbH
verbunden. "Native Instruments", "Traktor" und "Kontrol" sind Marken der
Native Instruments GmbH.

Danke an github.com/Opa-/x1-mk1-usb2midi (Apache-2.0) und
github.com/joherold/traktor_x1 für die Protokoll-Analyse. Verwendet
libusb (LGPL-2.1). Details stehen in NOTICE.txt.
